Converts an FSSpec to an FSRef.

OSErr PBMakeFSRefSync (
    FSRefParam *paramBlock
);

paramBlock

A pointer to a parameter block.

function result

A result code.

DISCUSSION

The relevant fields of the parameter block are:

• ioCompletion

  On input, a pointer to a completion routine.

• ioResult

  On output, the result code of the function.

• ioNamePtr

  On input, a pointer to a pathname. Specify the name of the file or directory.

• ioVRefNum

  On input, a volume specification for the volume containing the file or directory.

• ioDirID

  On input, a directory ID.

• newRef

  On output, the File Manager will construct and return a pointer to an FSRef for the file or directory.

To obtain an FSSpec from an FSRef, use the FSGetCatalogInfo call.

For the parameter block based calls, the fields of the source FSSpec are passed as separate parameters (ioNamePtr, ioVRefNum, and ioDirID). This allows the call to be dispatched to external filesystems the same way as other FSp calls are.

AVAILABILITY

Supported in Carbon. Available in Mac OS 9, and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)